OLA 文档中心

主题

2026-07-14

匹配绑定窗口图片2 - MatchWindowsFromPtrAll ​

函数简介 ​

匹配所有符合模板图片的坐标，模板通过内存指针传入，返回相对绑定窗口坐标。

接口名称 ​

MatchWindowsFromPtrAll

DLL调用 ​

long MatchWindowsFromPtrAll(long ola, int x1, int y1, int x2, int y2, long templ, double matchVal, int type, double angle, double scale);

参数说明 ​

参数名类型说明
ola长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
x1整数型查找区域的左上角X坐标。
y1整数型查找区域的左上角Y坐标。
x2整数型查找区域的右下角X坐标。
y2整数型查找区域的右下角Y坐标。
templ长整数型OLAImage对象的地址，由LoadImage等接口生成。
matchVal双精度浮点数相似度，如0.85，最大为1。
type整数型匹配类型：1-灰度匹配(速度快)；2-彩色匹配；3-透明匹配；4-透明彩色权重匹配；5-普通彩色匹配。
angle双精度浮点数旋转角度，每次匹配后旋转指定角度继续匹配，角度越小匹配次数越多时间越长，0为不旋转速度最快。
scale双精度浮点数窗口缩放比例，默认为1，可通过GetScaleFromWindows接口获取。

示例 ​

SDK 调用 ​

cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
long templPtr = ola.LoadImage("img/template.bmp");
if (templPtr != 0) {
    auto results = ola.MatchWindowsFromPtrAll(0, 0, 0, 0, templPtr, 0.9, 1, 0, 1);
    if (!results.empty() && results[0].MatchState) {
        int x = results[0].X;
        int y = results[0].Y;
    }
    // 后续不再使用该模板图时释放
    ola.FreeImage(templPtr);
}
csharp
using OLAPlug;

var ola = new OLAPlugServer();
long templPtr = ola.LoadImage("img/template.bmp");
if (templPtr != 0)
{
    var results = ola.MatchWindowsFromPtrAll(0, 0, 0, 0, templPtr, 0.9, 1, 0, 1);
    if (results.Count > 0 && results[0].MatchState)
    {
        int x = results[0].X;
        int y = results[0].Y;
    }
    // 后续不再使用该模板图时释放
    ola.FreeImage(templPtr);
}
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
templ_ptr = ola.LoadImage("img/template.bmp")
if templ_ptr:
    results = ola.MatchWindowsFromPtrAll(0, 0, 0, 0, templPtr, 0.9, 1, 0, 1)
    if results and results[0].get("MatchState"):
        x = results[0]["X"]
        y = results[0]["Y"]
    # 后续不再使用该模板图时释放
    ola.FreeImage(templ_ptr)
java
import com.olaplug.OLAPlugServer;
import com.olaplug.model.MatchResult;
import java.util.List;

OLAPlugServer ola = new OLAPlugServer();
long templPtr = ola.LoadImage("img/template.bmp");
if (templPtr != 0) {
    List<MatchResult> results = ola.MatchWindowsFromPtrAll(0, 0, 0, 0, templPtr, 0.9, 1, 0, 1);
    if (results != null && !results.isEmpty() && results.get(0).MatchState) {
        int x = results.get(0).X;
        int y = results.get(0).Y;
    }
    // 后续不再使用该模板图时释放
    ola.FreeImage(templPtr);
}
go
import "github.com/ola/olaplug/olaplug"

ola, _ := olaplug.NewOLAPlugServer("OLAPlug_x64.dll")
defer ola.ReleaseObj()
templPtr := ola.LoadImage("img/template.bmp")
if templPtr != 0 {
    auto results = ola.MatchWindowsFromPtrAll(0, 0, 0, 0, templPtr, 0.9, 1, 0, 1)
    if (!results.empty() && results[0].MatchState) {
        x := results[0].X
        y := results[0].Y
    }
    // 后续不再使用该模板图时释放
    ola.FreeImage(templPtr)
}
rust
use olaplug::OLAPlugServer;

let ola = OLAPlugServer::new("OLAPlug_x64.dll").unwrap();
let templPtr = ola.load_image("img/template.bmp");
if templPtr != 0 {
    auto results = ola.match_windows_from_ptr_all(0, 0, 0, 0, templPtr, 0.9, 1, 0, 1)
    if (!results.empty() && results[0].MatchState) {
        let x = results[0].X;
        let y = results[0].Y;
    }
    // 后续不再使用该模板图时释放
    ola.free_image(templPtr);
}
cpp
var ola = com("OlaPlug.OlaSoft")
var templPtr = ola.LoadImage("img/template.bmp")
if(templPtr) {
    var results = ola.MatchWindowsFromPtrAll(0, 0, 0, 0, templPtr, 0.9, 1, 0, 1)
    // 后续不再使用该模板图时释放
    ola.FreeImage(templPtr)
}
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
templPtr = ola.LoadImage("img/template.bmp")
If templPtr <> 0 Then
    results = ola.MatchWindowsFromPtrAll(0, 0, 0, 0, templPtr, 0.9, 1, 0, 1)
    ' 后续不再使用该模板图时释放
    ola.FreeImage(templPtr)
End If
text
.局部变量 ola, OLAPlug
.局部变量 retData, MatchData, , 数组
.局部变量 count, 整数型
.局部变量 rawstring, 文本型
.局部变量 templPtr, 长整数型
ola.创建 ()
templPtr ＝ ola.LoadImage ("img/template.bmp")
.如果真 (templPtr ≠ 0)
    count ＝ ola.MatchWindowsFromPtrAll (0, 0, 0, 0, templPtr, 0.9, 1, 0, 1, retData, rawstring)
    ' rawstring 为原始 JSON 文本（可省略该参数）
    .如果真 (count ＞ 0)
        ' retData 下标从 1 开始
    .如果真结束
    ola.FreeImage (templPtr)
.如果真结束
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var templPtr = ola.LoadImage("img/template.bmp");
if(templPtr){
    var results = ola.MatchWindowsFromPtrAll(0, 0, 0, 0, templPtr, 0.9, 1, 0, 1);
    // 后续不再使用该模板图时释放
    ola.FreeImage(templPtr);
}
text
变量 ola <类型 = OLAPlugServer>
变量 results <类型 = MatchDataList>
变量 templPtr <类型 = 长整数>
ola = 新建 OLAPlugServer
templPtr = ola.LoadImage("img/template.bmp")
如果真 (templPtr ≠ 0)
    results = ola.MatchWindowsFromPtrAll(0, 0, 0, 0, templPtr, 0.9, 1, 0, 1)
    ola.FreeImage(templPtr)
结束
cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
long templPtr = ola.LoadImage("img/template.bmp");
if (templPtr != 0) {
    auto results = ola.MatchWindowsFromPtrAll(0, 0, 0, 0, templPtr, 0.9, 1, 0, 1);
    if (!results.empty() && results[0].MatchState) {
        int32_t x = results[0].X;
    }
    // 后续不再使用该模板图时释放
    ola.FreeImage(templPtr);
}

原生 DLL 调用 ​

cpp
long instance = CreateCOLAPlugInterFace();
long ptr = MatchWindowsFromPtrAll(instance, 0, 0, 0, 0, templPtr, 0.9, 1, 0, 1);
if (ptr != 0) {
    char json[8192] = {0};
    GetStringFromPtr(ptr, json, sizeof(json));
    int matchState = 0, x = 0, y = 0, width = 0, height = 0, index = 0;
    double matchVal = 0, angle = 0;
    ParseMatchImageAllJson(instance, json, 0, &matchState, &x, &y, &width, &height, &matchVal, &angle, &index);
    FreeStringPtr(instance, ptr);
}
csharp
using System.Runtime.InteropServices;
using System.Text;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int GetStringFromPtr(long ptr, StringBuilder lpString, int size);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int FreeStringPtr(long ptr);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int GetStringSize(long ptr);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long CreateCOLAPlugInterFace();
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long MatchWindowsFromPtrAll(long ola, int x1, int y1, int x2, int y2, long templ, double matchVal, int type, double angle, double scale);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int ParseMatchImageAllJson(string str, int parseIndex, out int matchState, out int x, out int y, out int width, out int height, out double matchVal, out double angle, out int index);

long instance = CreateCOLAPlugInterFace();
long ptr = MatchWindowsFromPtrAll(instance, 0, 0, 0, 0, templPtr, 0.9, 1, 0, 1);
if (ptr != 0) {
    StringBuilder sb = new StringBuilder(GetStringSize(ptr) + 1);
    GetStringFromPtr(ptr, sb, sb.Capacity);
    FreeStringPtr(ptr);
    ParseMatchImageAllJson(sb.ToString(), 0, out int matchState, out int x, out int y, out int w, out int h, out double mv, out double ang, out int idx);
}
python
from ctypes import CDLL, c_int, c_int64

ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
instance = ola.CreateCOLAPlugInterFace()
ptr = ola.MatchWindowsFromPtrAll(instance, ...)
# 原生返回 JSON 数组指针，用 ParseMatchImageAllJson(instance, json, 0, ...) 取第一项

返回值 ​

调用方式返回值说明
SDKMatchData/MatchResult 列表（Python 为 list[dict]）全部匹配结果；空列表表示未找到
SDK（火山）MatchDataList结构化结果列表
SDK（易语言）整数型 + retData（MatchData 数组）返回找到数量，结果写入 retData；内部为 GetStringFromPtr + OL_获取MatchDataAll
原生 DLL非 0成功，返回 JSON 数组字符串指针，需调用 FreeStringPtr 释放
原生 DLL0失败

返回数据格式：

json
[{
    "MatchVal": 0.85,
    "MatchState": true,
    "Index": 0,
    "Angle": 45.0,
    "X": 100,
    "Y": 200,
    "Width": 100,
    "Height": 100
}]
字段名类型说明
MatchVal浮点数匹配相似度。
MatchState布尔是否匹配成功。
Index整数结果索引（从 0 开始）。
Angle浮点数匹配角度。
X整数X 坐标。
Y整数Y 坐标。
Width整数宽度。
Height整数高度。

注意事项 ​

项目说明
搜索范围x1、y1、x2、y2都传0时，将搜索整个窗口客户区。
坐标系返回的坐标是相对于绑定窗口客户区的坐标。